New-API 接入指南

什么是 New-API

New-API 是一个智能网关工具,可以让你用一个统一接口对接多种 AI 服务(如文心一言、通义千问等)。

通过它,你可以方便地将非标准的 AI 服务接入到 PIG AI 系统中。

New-API概览
核心优势

New-API 作为中间层网关,统一了不同 AI 服务商的接口标准,让 PIG AI 系统可以无缝对接各类大模型服务。

支持的模型

模型服务商说明
OpenAIChatGPT 系列模型(支持 Azure OpenAI API)
AnthropicClaude 系列模型(支持 AWS Claude)
GooglePaLM2/Gemini 系列模型
MistralMistral 系列模型
字节跳动豆包大模型
百度文心一言系列模型
阿里通义千问系列模型
讯飞星火认知大模型
智谱ChatGLM 系列模型
360智脑
腾讯混元大模型
MoonshotMoonshot AI
百川百川大模型
MINIMAXMINIMAX
GroqGroq
OllamaOllama
零一万物零一万物
阶跃星辰阶跃星辰
CozeCoze
CohereCohere
DeepSeekDeepSeek
CloudflareWorkers AI
DeepLDeepL
Together.aiTogether.ai
Novita.aiNovita.ai
硅基流动SiliconCloud
xAIxAI

快速安装

推荐使用 Docker Compose

我们强烈推荐使用 Docker Compose 方式部署,而不是手动启动 Docker 容器。Docker Compose 提供了更好的配置管理、服务编排和部署体验。

基本要求

  • 已安装 Docker 环境
  • 端口:默认使用 3000 端口

使用 SQLite 数据库(不推荐)

docker run --name new-api -d --restart always \
  -p 3000:3000 \
  -e TZ=Asia/Shanghai \
  -v /your/data/path:/data \
  calciumion/new-api:latest
注意

请将 /your/data/path 替换为您想要存储数据的本地路径。

使用 MySQL 数据库

docker run --name new-api -d --restart always \
  -p 3000:3000 \
  -e SQL_DSN="用户名:密码@tcp(数据库地址:3306)/数据库名" \
  -e TZ=Asia/Shanghai \
  -v /your/data/path:/data \
  calciumion/new-api:latest
注意

请替换参数中的数据库连接信息。

访问系统

部署完成后,访问 http://服务器IP:3000 将自动引导到初始化页面。按照页面指引手动设置管理员账号和密码(仅首次安装需要),完成后即可使用新设置的管理员账号登录系统。

配置步骤

第一步:添加 AI 服务渠道

渠道配置界面
  1. 登录后点击菜单「渠道」->「新建渠道」
  2. 选择「火山方舟」(豆包模型)
  3. 填写渠道信息:
    • 渠道名称:自定义(如「我的豆包服务」)
    • 模型:从火山引擎控制台获取【接入点名称】
    • API Key:从火山引擎控制台获取
    • 其他参数保持默认
获取凭证

API Key 和接入点名称需要在火山引擎控制台的模型推理服务中获取,请提前准备好这些信息。

第二步:获取对接密钥

  1. 点击左侧菜单「令牌」
  2. 点击「新建令牌」
  3. 复制生成的密钥(这个密钥后续要填到 PIG AI 系统中)
密钥获取界面
密钥安全

生成的密钥只会显示一次,请妥善保存。如果遗失需要重新生成新的密钥。

第三步:PIG AI 系统配置

  1. 进入 PIG AI 系统设置
  2. 选择 AI 服务商为「NewAPI」
  3. 填写信息:
    • API 地址:http://你的服务器IP:3000
    • API 密钥:上一步复制的密钥
    • 模型名称:必须填写火山豆包的接入点名称
PIG配置界面
配置提示

如果下拉菜单没有 NewAPI 选项,请联系技术人员在文件 /src/views/knowledge/aiModel/model.ts 中添加相应配置。

模型名称

模型名称必须与 New-API 中配置的接入点名称完全一致,否则会导致调用失败。